home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / Xm / XmStringUnparse.z / XmStringUnparse
Encoding:
Text File  |  2001-04-17  |  7.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSttttrrrriiiinnnnggggUUUUnnnnppppaaaarrrrsssseeee((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmSSSSttttrrrriiiinnnnggggUUUUnnnnppppaaaarrrrsssseeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmSSSSttttrrrriiiinnnnggggUUUUnnnnppppaaaarrrrsssseeee - A compound string function that unparses
  10.           text
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/Xm.h>
  14.           XXXXttttPPPPooooiiiinnnntttteeeerrrr XXXXmmmmSSSSttttrrrriiiinnnnggggUUUUnnnnppppaaaarrrrsssseeee(
  15.           XXXXmmmmSSSSttttrrrriiiinnnngggg ssssttttrrrriiiinnnngggg,
  16.           XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaagggg ttttaaaagggg,
  17.           XXXXmmmmTTTTeeeexxxxttttTTTTyyyyppppeeee ttttaaaagggg____ttttyyyyppppeeee,
  18.           XXXXmmmmTTTTeeeexxxxttttTTTTyyyyppppeeee oooouuuuttttppppuuuutttt____ttttyyyyppppeeee,
  19.           XXXXmmmmPPPPaaaarrrrsssseeeeTTTTaaaabbbblllleeee ppppaaaarrrrsssseeee____ttttaaaabbbblllleeee,
  20.           CCCCaaaarrrrddddiiiinnnnaaaallll ppppaaaarrrrsssseeee____ccccoooouuuunnnntttt,
  21.           XXXXmmmmPPPPaaaarrrrsssseeeeMMMMooooddddeeeellll ppppaaaarrrrsssseeee____mmmmooooddddeeeellll);
  22.  
  23.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  24.           This page documents Motif 2.1.
  25.  
  26.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.           XXXXmmmmSSSSttttrrrriiiinnnnggggUUUUnnnnppppaaaarrrrsssseeee looks in the input _s_t_r_i_n_g for text segments
  28.           that are tagged with locale or charset tags that match _t_a_g.
  29.           The _t_a_g__t_y_p_eparameter specifies whether the tag is a locale
  30.           or charset type.  If _t_a_g has a value of NULL, all the
  31.           segments are matched. When a text segment is found with a
  32.           matching tag, it is added to the end of a resulting string.
  33.           The characters in the resulting string are of type
  34.           _o_u_t_p_u_t__t_y_p_e.
  35.  
  36.           XXXXmmmmSSSSttttrrrriiiinnnnggggUUUUnnnnppppaaaarrrrsssseeee also checks _s_t_r_i_n_g for components that match
  37.           components in _p_a_r_s_e__t_a_b_l_e, and also to see if the component
  38.           matches the condition specified by _p_a_r_s_e__m_o_d_e_l. If the
  39.           string component matches in both checks, then the associated
  40.           character is added to the end of the resulting string.
  41.  
  42.           _s_t_r_i_n_g    Specifies the XXXXmmmmSSSSttttrrrriiiinnnngggg to be converted.
  43.  
  44.           _t_a_g       Specifies the tag to be used in matching with text
  45.                     segments. Only text segments that match _t_a_g will
  46.                     be included in the resulting string. If _t_a_g has a
  47.                     value of NULL, all segments are considered as
  48.                     matches, and _t_a_g__t_y_p_e is ignored.
  49.  
  50.           _t_a_g__t_y_p_e  Specifies the type of tag to be searched for,
  51.                     including XXXXmmmmMMMMUUUULLLLTTTTIIIIBBBBYYYYTTTTEEEE____TTTTEEEEXXXXTTTT, XXXXmmmmWWWWIIIIDDDDEEEECCCCHHHHAAAARRRR____TTTTEEEEXXXXTTTT, and
  52.                     XXXXmmmmCCCCHHHHAAAARRRRSSSSEEEETTTT____TTTTEEEEXXXXTTTT.
  53.  
  54.           _o_u_t_p_u_t__t_y_p_e
  55.                     Specifies the type of text to be returned in the
  56.                     string, including XXXXmmmmMMMMUUUULLLLTTTTIIIIBBBBYYYYTTTTEEEE____TTTTEEEEXXXXTTTT,
  57.                     XXXXmmmmWWWWIIIIDDDDEEEECCCCHHHHAAAARRRR____TTTTEEEEXXXXTTTT, and XXXXmmmmCCCCHHHHAAAARRRRSSSSEEEETTTT____TTTTEEEEXXXXTTTT.
  58.  
  59.           _p_a_r_s_e__t_a_b_l_e
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 4/6/01)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmSSSSttttrrrriiiinnnnggggUUUUnnnnppppaaaarrrrsssseeee((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmSSSSttttrrrriiiinnnnggggUUUUnnnnppppaaaarrrrsssseeee((((3333XXXX))))
  71.  
  72.  
  73.  
  74.                     Specifies the parse table to be used in scanning
  75.                     for compound string components to be converted to
  76.                     other characters.
  77.  
  78.           _p_a_r_s_e__c_o_u_n_t
  79.                     Specifies how many entries are in _p_a_r_s_e__t_a_b_l_e.
  80.  
  81.           _p_a_r_s_e__m_o_d_e_l
  82.                     Specifies which non-text components to be
  83.                     considered in matching in _p_a_r_s_e__t_a_b_l_e. These
  84.                     include:
  85.  
  86.                     XXXXmmmmOOOOUUUUTTTTPPPPUUUUTTTT____AAAALLLLLLLL
  87.                               Puts out all matching components.
  88.  
  89.                     XXXXmmmmOOOOUUUUTTTTPPPPUUUUTTTT____BBBBEEEETTTTWWWWEEEEEEEENNNN
  90.                               Puts out only those matching components
  91.                               that are between two matching text
  92.                               components.
  93.  
  94.                     XXXXmmmmOOOOUUUUTTTTPPPPUUUUTTTT____BBBBEEEEGGGGIIIINNNNNNNNIIIINNNNGGGG
  95.                               Puts out only those matching components
  96.                               that are at the beginning of a matching
  97.                               text component.
  98.  
  99.                     XXXXmmmmOOOOUUUUTTTTPPPPUUUUTTTT____EEEENNNNDDDD
  100.                               Puts out only those matching components
  101.                               that are at the end of a matching text
  102.                               component.
  103.  
  104.                     XXXXmmmmOOOOUUUUTTTTPPPPUUUUTTTT____BBBBOOOOTTTTHHHH
  105.                               Puts out only those matching components
  106.                               that are at the beginning or end of a
  107.                               matching text component.
  108.  
  109.      RRRREEEETTTTUUUURRRRNNNN
  110.           Returns a newly allocated string containing characters of a
  111.           type determined by _o_u_t_p_u_t__t_y_p_e.  The application is
  112.           responsible for managing this allocated space.  The
  113.           application can recover this allocated space by calling
  114.           XXXXttttFFFFrrrreeeeeeee.
  115.  
  116.      RRRREEEELLLLAAAATTTTEEEEDDDD
  117.           XXXXmmmmSSSSttttrrrriiiinnnngggg(3), XXXXmmmmPPPPaaaarrrrsssseeeeTTTTaaaabbbblllleeee(3), XXXXmmmmPPPPaaaarrrrsssseeeeMMMMaaaappppppppiiiinnnngggg(3).
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 4/6/01)
  130.  
  131.  
  132.  
  133.